home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / pecho10o.arc / PECHO.DOC < prev    next >
Text File  |  1991-01-03  |  20KB  |  581 lines
  1.  
  2.  
  3.  
  4.      PECHO.TXT                 Thursday, October 11, 1990                 Page 1
  5.  
  6.  
  7.         
  8.       
  9.       
  10.       
  11.       
  12.       
  13.       
  14.       
  15.       
  16.       
  17.                                    Pecho
  18.                           Point Echo Maintenance
  19.                  Copy Right 1990 by Herbert E. Brown, Jr.
  20.                             All Rights Reserved
  21.                              ShareWare Edition
  22.       
  23.       
  24.       
  25.       
  26.       
  27.       
  28.       
  29.       
  30.       
  31.       
  32.       
  33.       
  34.       
  35.       
  36.       
  37.       
  38.       
  39.       
  40.       
  41.       
  42.       
  43.       
  44.       
  45.       
  46.       
  47.       
  48.       
  49.       
  50.       
  51.       
  52.       
  53.       
  54.       
  55.       
  56.       
  57.       
  58.       
  59.       
  60.       
  61.       
  62.  
  63.  
  64.  
  65.      PECHO.TXT                 Thursday, October 11, 1990                 Page 2
  66.  
  67.  
  68.                                      
  69.                                     
  70.                              Table of Contents
  71.       
  72.       
  73.       
  74.       
  75.      Licesense Agreement.................................ii
  76.       
  77.      Introduction........................................1  
  78.       
  79.      Getting Started.....................................1  
  80.       
  81.      Configuring Pecho...................................2
  82.       
  83.      Daily Chores........................................4
  84.       
  85.      Sample Session......................................4
  86.       
  87.      Summary.............................................6
  88.       
  89.      Registration Info...................................7
  90.       
  91.       
  92.       
  93.       
  94.       
  95.       
  96.       
  97.       
  98.       
  99.       
  100.       
  101.       
  102.       
  103.       
  104.       
  105.       
  106.       
  107.       
  108.       
  109.       
  110.       
  111.       
  112.       
  113.       
  114.       
  115.       
  116.       
  117.       
  118.       
  119.       
  120.       
  121.       
  122.       
  123.  
  124.  
  125.  
  126.      PECHO.TXT                 Thursday, October 11, 1990                 Page 3
  127.  
  128.  
  129.                              LICENSE AGREEMENT
  130.       
  131.      PEcho  software product is NOT "Public Domain" and it is NOT           
  132.      "Freeware".     PEcho  is  a  copyrighted  software  product 
  133.      developed  and owned by  Herbert E.  Brown  Jr.  located  in 
  134.      Metairie, Louisiana U. S. A. Herbert E. Brown Jr. grants you 
  135.      without  charge the right to reproduce,  distribute and  use 
  136.      copies  of  this  version  of my  Pecho  shareware  software 
  137.      product,  subject to the limitations specified below, and on 
  138.      the  express condition that you do not receive any  payment, 
  139.      commercial   benefit,   or  other  consideration  for   such 
  140.      reproduction  or  distribution,   or  change  this   license 
  141.      agreement or the following copyright notice which appears in 
  142.      the  software,  documentation,  user  interface,  menus  and 
  143.      magnetic  media:  (C)  Copyright  1990 All  rights  reserved 
  144.      worldwide.
  145.       
  146.      Limitations:  You  may make and keep one (1)back-up copy  of 
  147.      the  software for your personal use,  provided that (i)  you 
  148.      copy  all the copyright,  trademark,  and other  information 
  149.      indicated on the initial screen display (or on the  diskette 
  150.      label,  for  the  registered version disk) onto your  backup 
  151.      diskette label,  and (ii) you have registered.  Also you may 
  152.      distribute  copies to other persons,  but solely  for  their 
  153.      evaluation  (i.e.,  to decide whether to continue using  the 
  154.      product and therefore register) and solely for evaluation by 
  155.      such other persons during that thirty (30) day period. PEcho 
  156.      must  NOT  be  sold without expressed written  consent  from 
  157.      Herbert E. Brown Jr.
  158.       
  159.      The  rights to receive any such financial or other  benefit, 
  160.      and  to modify the product or employ its components  in  any 
  161.      kind of derivative work, are reserved exclusively by Herbert 
  162.      E.  Brown  Jr.  Support  from  users enables me  to  develop 
  163.      additional  features  and  future  versions  of  the   PEcho 
  164.      product.
  165.       
  166.      Also,  please  feel free to contribute your ideas  regarding 
  167.      desired additional product features and functionality.
  168.       
  169.      THIS  PRODUCT  IS LICENSED "AS IS" WITHOUT ANY  WARRANTY  OF 
  170.      MERCHANTABILITY   OR  FITNESS  FOR  A  PARTICULAR   PURPOSE, 
  171.      PERFORMANCE,  OR  OTHERWISE;  ALL  WARRANTIES ARE  EXPRESSLY 
  172.      DISCLAIMED.  BY  USING  THE PECHO PRODUCT,  YOU  AGREE  THAT 
  173.      NEITHER HERBERT E.  BROWN JR.  NOR ANY OFFICERS,  DIRECTORS, 
  174.      EMPLOYEES,   SHAREHOLDERS,   AFFILIATES,  OWNERS,  OR  OTHER 
  175.      RELATED PARTIES WILL BE LIABLE TO YOU OR ANY THIRD PARTY FOR 
  176.      ANY  USE  OF (OR INABILITY TO USE) OR  PERFORMANCE  OF  THIS 
  177.      PRODUCT,  OR  FOR  ANY DAMAGES WHATSOEVER WHETHER  BASED  ON 
  178.      CONTRACT, TORT OR OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH 
  179.      POSSIBILITY  IN  ADVANCE.  (SOME  STATES DO  NOT  ALLOW  THE 
  180.      EXCLUSION  OR  LIMITATION  OF  INCIDENTAL  OR  CONSEQUENTIAL 
  181.      DAMAGES, SO THE FOREGOING LIMITATION MAY NOT APPLY TO YOU.)
  182.      You may not reverse-engineer, disassemble, modify, decompile 
  183.      or create derivative works of the product. 
  184.  
  185.  
  186.  
  187.      PECHO.TXT                 Thursday, October 11, 1990                 Page 4
  188.  
  189.  
  190.      PEcho v1.0
  191.       
  192.      Introduction
  193.       
  194.      PEcho  is  a  sharware utility designed  to  allow  Fido-Net 
  195.      Points that use the FTSC *.MSG format to add and delete echo 
  196.      mail  areas.  It  is designed to be easy to use and easy  to 
  197.      setup.   It allows use  of a "valid" echo listing to  ensure 
  198.      proper  distribution  of your echo mail when it is  received 
  199.      and  relieves  the user of possible errors  associated  with 
  200.      creating  the  required directories and  data  files.   This 
  201.      release only supports single nodes.   Future realeases  will 
  202.      support multiple node points.
  203.       
  204.      Getting Started.
  205.       
  206.      Once   the  distibution  archive  is  un-compressed,   place 
  207.      Pecho.exe in your point home directory.  I.e., if your point 
  208.      is run from 
  209.      c:\bbs,  place this file there.   Pecho.cfg should be placed 
  210.      in the same directory.
  211.       
  212.       
  213.      There are a few things you must do in order to get PEcho  to 
  214.      work  properly.   You will need to double check a few things 
  215.      to insure that PEcho and your system will work together. 
  216.       
  217.      Your Sub-directories.
  218.       
  219.      PEcho makes one assumption about your AREAS file and that is 
  220.      the length of the names of the sub-directories.  PEcho will, 
  221.      when  in operation,  use the fisrt 8 characters of the  echo 
  222.      name  to create the sub-directory for that  echo.   This  is 
  223.      important  because  if  you have any echos whose  names  are 
  224.      longer than 8 charcaters, but, use less than 8 charcaters in 
  225.      the sub-directory name, will cause PEcho to ignore your sub-
  226.      directory.    You MUST check you sub-directories and  insure 
  227.      that  they  are the maximum length of the name  allowed  for 
  228.      that  echo.   In example,  if you are currently recieving an 
  229.      echo entitled,  MUSICIAN'S_SERVICES,  which is 19 characters 
  230.      long,  and your sub-directory is called MUSIC for this echo, 
  231.      you  should rename the sub-directory to MUSICIAN.   This  is 
  232.      important when it comes time for deleting the echos.
  233.       
  234.      Configuring PEcho for your POINT.
  235.       
  236.      PEcho's configuration file is well documeneted, but, some 
  237.      explanation is needed here.   First,  and most important, is 
  238.      that each line of the configuartion file has a comment line, 
  239.      the configuartion constant,  and a blank line seperating the 
  240.      next  comment line.   PEcho is expecting this format and any 
  241.      deviation will cause PEcho not to operate properly.
  242.       
  243.      The first constant is the name of your point, enter the name 
  244.      of your point as it is found in your origin line.
  245.  
  246.  
  247.  
  248.      PECHO.TXT                 Thursday, October 11, 1990                 Page 5
  249.  
  250.  
  251.       
  252.      ; Name of Point
  253.      Your Point Name
  254.       
  255.      Enter  your name as it is found in your AREAS file.
  256.       
  257.      ; Sysop of Point
  258.      Your Name 
  259.       
  260.      Enter your PRIVATE NET ADDRESS.  This can be found in either 
  261.      your  message  editor  configuration  file  or  your  mailer 
  262.      configuration file, such as BINKLEY.CFG.
  263.       
  264.      ; Your PrivateNet address
  265.      30000/10
  266.       
  267.      Enter  your  boss's net/node address that you get your  mail 
  268.      from.
  269.       
  270.      ; Your Boss's net/node address
  271.      396/5
  272.       
  273.      If your boss node is using AREAFIX or some other hub echo 
  274.      manager, enter the password that is needed to access it.
  275.       
  276.      ; Your Password to your boss node
  277.      ghyjikl
  278.       
  279.       
  280.      Enter the path to your net-mail directory here.   Do not add 
  281.      a "\" at the end.
  282.       
  283.      ; Net-Mail message path
  284.      e:\bbs\msg\net
  285.       
  286.      Enter the path to your AREAS file.   Again,  do not enter  a 
  287.      "\" at the end.
  288.       
  289.      ; Path to AREAS file
  290.      e:\bbs
  291.       
  292.      Enter the name of the AREAS file that you use.
  293.       
  294.      ; Name of AREAS file                     
  295.      AREAS.BBS
  296.       
  297.      Enter the name that allows you acces to your boss's hub echo 
  298.      software.
  299.       
  300.      ; Pseudonym of boss                    
  301.      Areafix
  302.       
  303.      Enter a path to the valid echo listing.  Do not enter a  "\" 
  304.      at the end.
  305.       
  306.  
  307.  
  308.  
  309.      PECHO.TXT                 Thursday, October 11, 1990                 Page 6
  310.  
  311.  
  312.      ; Path to vaild echo listing
  313.      e:\bbs\txt
  314.       
  315.      Enter the name of the file to use as the valid echo listing.
  316.       
  317.      ; Valid echo listing file name
  318.      AREAS.SS
  319.       
  320.      Enter  the  string  to  use for  your  renumbering  utility.           
  321.       
  322.      ; Message utility default string
  323.      ReNum -d 3 -r
  324.       
  325.      Enter  the path to the message areas.   Do not add a "\"  at 
  326.      the end.
  327.       
  328.      ; path to message areas
  329.      e:\bbs\msg
  330.       
  331.       
  332.       
  333.      About your DAILY chores batch file.  Normaly, without PEcho, 
  334.      you would have your daily batch file renumber and delete old 
  335.      messages  in your echos.   However,  with the use of  PEcho, 
  336.      updating  your  daily file could be very  tediuos.   So,  to 
  337.      simplify  things,  PEcho writes a seperate batch file  which 
  338.      you should CALL from your daily batch file.   In your  daily 
  339.      batch  file,  you should use a word processor and block  out 
  340.      the  sections  that  renumber your messages and  write  this 
  341.      block  to  a  batch file  called  RE_NUM.BAT.  Also,  it  is 
  342.      important  to know that PEcho in know way upadtes  your  net 
  343.      mail area.   So, you should have at least a call to renumber 
  344.      this  area,  before you call the RE_NUM.BAT batch file  that 
  345.      renumbers your messages.. i.e..
  346.       
  347.       
  348.      daily.bat...
  349.      ..
  350.      .. 
  351.      renum -d 3 -r e:\bbs\net
  352.      call re_num.bat
  353.      ..
  354.      ..
  355.      etc.
  356.       
  357.       
  358.       
  359.       
  360.       
  361.       
  362.       
  363.       
  364.       
  365.       
  366.       
  367.  
  368.  
  369.  
  370.      PECHO.TXT                 Thursday, October 11, 1990                 Page 7
  371.  
  372.  
  373.       
  374.      Using MREN.
  375.       
  376.      PEcho partialy supports MREN.   MREN does not need a line in 
  377.      a  batch  file for every echo found.   It also can  imbed  a 
  378.      command   word   in  your  AREAS  file  to  support   varied 
  379.      renumbering schemes.   Therfore, if MREN is specified, PEcho 
  380.      does  not write a seperate batch file for  renumbering  your 
  381.      echos.   Instead,  you should leave your daily batch routine 
  382.      for  this  job.   You  may  also imbed  commands  that  MREN 
  383.      supports in your AREAS,  but,  PEcho will ignore them,  both 
  384.      reading  and  writing  to your AREAS  file.   This  will  be 
  385.      remedied in future updates of PEcho. 
  386.       
  387.      A sample session
  388.       
  389.      Start by typing PECHO at the DOS prompt.  You will see the 
  390.      opening  screen and a message indicating the echo areas  are 
  391.      being  loaded and sorted into memory.   Once the listing  is 
  392.      loaded into memory,  the main menu will appear.   From  here 
  393.      you will be able to ADD, STOP, START, and REMOVE echos.
  394.       
  395.      Start by selecting 1, ADD Echo.
  396.       
  397.      PEcho   works by allowing the you to choose from a  list  of 
  398.      what  echos  you wish to add.   Simply use the up  and  down 
  399.      arrow keys,  the page up or page down keys,  or the home and 
  400.      end  keys to manuever through the listing.   By hitting  the 
  401.      space bar on the highlighted selection,  a user can mark the 
  402.      echos to be added.
  403.       
  404.       
  405.       
  406.       
  407.      Once a choice is made,  the echo name is placed in an  "ADD" 
  408.      window so that the you can make more selections if so desired.  
  409.      Once you are happy with the selections, simply hit the "esc" 
  410.      key  once and a status line will appear on the bottom of the 
  411.      screen.   This status line gives you further instructions on 
  412.      how to process the additions.   If you have made an error in 
  413.      a selection,  i.e.,  an echo you don't want,  simply hit the 
  414.      space bar once and the main selection window will disappear.  
  415.      The first entry in the "ADD" window will be highlighted  and 
  416.      you  can  then move to other selections and delete  them  by 
  417.      pressing  the  space  bar,  if so  desired.   Once  you  are 
  418.      satisified with your new selections,  simply press the Enter 
  419.      key  and your selections will automaticaly be added to  your 
  420.      AREAS  file and your message maintenance batch file will  be 
  421.      updated, as well.  The necessary subdirectories will also be 
  422.      created and the net-mail message will be placed in your net-
  423.      mail subdirectory for your boss node.
  424.       
  425.       
  426.      One  added  feature is if you accidently choose an echo  you 
  427.      already  have,  a  window  will pop up to the  left  of  the 
  428.  
  429.  
  430.  
  431.      PECHO.TXT                 Thursday, October 11, 1990                 Page 8
  432.  
  433.  
  434.      selections  window  and it will automaticaly  highlight  the 
  435.      echo that is trying to be duplicated.  Stopping and Starting 
  436.      echos.
  437.       
  438.      The  menu  choice  Stop an echo was designed to  stop  echos 
  439.      either  permanently or temporarily.   By selecting this menu 
  440.      choice you will see a window on the left side of your screen 
  441.      pop  up.   It will contain all your currently ACTIVE  echos.  
  442.      An ACTIVE echo is defined here as an echo that is  currently 
  443.      in your AREAS file.   If an echo is not listed in your AREAS 
  444.      file, it is considered in-active.  As in adding an echo, you 
  445.      may use any of the editing keys available,  i.e., up cursor, 
  446.      down cursor, etc., to move through this listing.  
  447.       
  448.      By pressing the space bar, you will mark the currently 
  449.      highlighted  echo for stopping.   As before,  once  you  are 
  450.      happy  with  the selections,  pressing ESC will bring  up  a 
  451.      status line with more information.  By hitting Space, you be 
  452.      able  to  delete these selections from the  listing,  or  by 
  453.      pressing  Enter,  you  will confirm your selections and  the 
  454.      echos  will  be stopped by a net-mail message to  your  boss 
  455.      node.   This DOES NOT DELETE THE ECHO! This simply gets "the 
  456.      ball rolling" sort of speaking.  The message must be sent to 
  457.      your  boss  node AND you should wait until  your  boss  node 
  458.      responds with a message indicating the feed was stopped.
  459.       
  460.      In most cases, you will be sent a message the very next time 
  461.      you  connect to your boss node.   Once you have recieved the 
  462.      message(s)  indicating the feed was stopped,  you  may  then 
  463.      either re-start the echo at a later date, or, you may REMOVE 
  464.      that echo by selecting menu choice number four from the main 
  465.      menu.
  466.       
  467.      Echos names that are stopped,  for whatever reason, are kept 
  468.      in a text database file residing in your home mail directory.  
  469.      You  could conceivable add to this file with a wordprocessor 
  470.      if  you  wish,  however,  take care in  insuring  that  data 
  471.      integrity   is maintained.  I.e., if you add an echo to this 
  472.      listing,  make  sure that an associated sub-directory exists 
  473.      and that the name is either the whole or eight characters of 
  474.      the  name of the subdirectory,  whichever  is  greater.   In 
  475.      other words,  if the echo name is 20 charcters long, be sure 
  476.      and  use  the  first 8 characters of this name as  the  sub-
  477.      directory name.   If you add to this file you will also have 
  478.      to insure that the area exist in your AREAS file, as well.
  479.       
  480.      When you remove an echo, your AREAS file will be updated, as 
  481.      well as your message maintenance batch file. 
  482.       
  483.       
  484.       
  485.       
  486.       
  487.       
  488.       
  489.  
  490.  
  491.  
  492.      PECHO.TXT                 Thursday, October 11, 1990                 Page 9
  493.  
  494.  
  495.       
  496.       
  497.      * IMPORTANT! * 
  498.       
  499.      If you have any messages that you wish to keep, make copies, 
  500.      backups,  or  whatever  before choosing  this  option.   ALL 
  501.      message files and lastread pointer files will be deleted and 
  502.      you will NOT be prompted to stop this.
  503.       
  504.       
  505.       
  506.      In summary.
  507.       
  508.      Check  your  sub-directory  names  and make  sure  that  the 
  509.      lengths of the names are as prescibed above.
  510.       
  511.      There should be a name in your AREAS file and a coresponding 
  512.      name in your AREAS file.
  513.       
  514.      Set up the configuaration file to your needs.
  515.       
  516.      If using RENUM, create a message maintenance batch file from 
  517.      your daily chores file.
  518.       
  519.      Also, if you make a mistake in setting up, adding an echo or 
  520.      deleting an echo,  etc., you should delete any messages that 
  521.      are  sent  to your net mail area.   Adjust your  AREAS  file 
  522.      accordingly, and adjust your message maintenance batch file.  
  523.      You  may  also  need  to  create/delete  sub-directories  as 
  524.      needed.
  525.       
  526.      About the valid listing file.  You may use any text file that
  527.      lists any or all the echos from your hub.  As an example,
  528.      one is provided.  By the time you get to this file, it may
  529.      be dated.  The file requirements for this file is a plain
  530.      ASCII file with a carriage return after each name in the
  531.      file.  One name per line.
  532.       
  533.       
  534.       
  535.       
  536.       
  537.       
  538.       
  539.       
  540.       
  541.       
  542.       
  543.       
  544.       
  545.       
  546.       
  547.       
  548.       
  549.       
  550.  
  551.  
  552.  
  553.      PECHO.TXT                Thursday, October 11, 1990                 Page 10
  554.  
  555.  
  556.       
  557.      Registration
  558.       
  559.      This is a shareware product.  If you find it usefull, please 
  560.      register  it.   No  part of this program is hindered in  any 
  561.      way.   It  is  a fully functional  program,  as  it  stands.  
  562.      Registered  users  will have preference in updates  and  new 
  563.      releases,  as well.  The cost of registration is only $10.00 
  564.      USA currency only.
  565.       
  566.      Please send check or money orders only to:
  567.       
  568.                       Herbert Brown
  569.                       616 Oriole Street 
  570.                       Metairie LA 70003
  571.       
  572.      Please include your US Mailing address or other Snail Mail 
  573.      address,  Fido-net address,  and a telephone number in cases 
  574.      were technical support would be needed.
  575.       
  576.      FidoNet is trademark of IFNA
  577.      AREAFIX is copy righted by Greg Dawson
  578.      Renum is copy righted by Bob Hartman and Spark Software
  579.      Mren is copy righted by David Nugent and Unique Computing P/L
  580.       
  581.